Installation & Setup

Before you begin, ensure you have:

• VS Code (or a VS Code–compatible editor such as Cursor or Windsurf) installed
  → https://code.visualstudio.com/
• A DevAssure account
  → https://app.devassure.io

---

Install the extension

1. Open VS Code → Extensions view (Ctrl+Shift+X).
2. Search DevAssure Invisible (QA) Agent.
3. Click Install.

Or use the direct links:

• VS Code Marketplace
• Open VSX

Login

1. Click the DevAssure icon in the left sidebar.
2. Click Login in the welcome panel.
3. Your browser opens for OAuth2 authentication.

---

Initialize a Project

1. In the DevAssure sidebar, click Initialize DevAssure.
2. Choose your workspace folder.
3. Enter:
   • App URL — the base URL of the app under test
   • App description — a brief description of the application
   • Personas — one or more user personas (name + short description)

The extension creates a .devassure/ folder with all configuration files and a sample test.

---

The .devassure folder

All configuration and tests live under .devassure/ in your project root.

Path	Purpose
app.yaml	App description and rules for the agent
personas.yaml	(Optional) User personas used in tests
test_data.yaml	Default URL, users, and test data per environment
agent_instructions.yaml	Runtime instructions for the agent (e.g., retry rules)
preferences.yaml	Browser engine, resolution, headless mode, parallel workers
csv_mapping.yaml	Maps CSV column headers to test case fields
tests/ or test/	YAML test files and optional CSV files
actions/	Reusable step groups (action YAML files)
tools/	Custom tools; tools/index.yaml defines tool commands

---

note

If .devassure/ already exists, you will be prompted to confirm before overriding it.